/*
[说明] Decorator 提案经过了大幅修改，目前还没有定案，不知道语法会不会再变。
下面的内容完全依据以前的提案，已经有点过时了。等待定案以后，需要完全重写。

装饰器（Decorator）是一种与类（class）相关的语法，用来注释或修改类和类方法。
许多面向对象的语言都有这项功能，目前有一个提案将其引入了 ECMAScript。

装饰器是一种函数，写成@ + 函数名。它可以放在类和类方法的定义前面。
*/

@frozen class Foo {
	@configurable(false)
	@enumerable(true)
	method() {}

	@throttle(500)
	expensiveMethod() {}
}

/*
上面代码一共使用了四个装饰器，一个用在类本身，另外三个用在类方法。
它们不仅增加了代码的可读性，清晰地表达了意图，而且提供一种方便的手段，增加或修改类的功能。
*/

/*
装饰器可以用来装饰整个类。
*/
@testable
class MyTestableClass {
	// ...
}

function testable(target) {
	target.isTestable = true;
}

MyTestableClass.isTestable // true

/*
上面代码中， @testable就是一个装饰器。
 它修改了MyTestableClass这个类的行为， 为它加上了静态属性isTestable。
  testable函数的参数target是MyTestableClass类本身。
  */

/*
基本上， 装饰器的行为就是下面这样。
也就是说，装饰器是一个对类进行处理的函数。装饰器函数的第一个参数，就是所要装饰的目标类。
*/
@decorator
class A {}

// 等同于

class A {}
A = decorator(A) || A;

function testable(target) {
	// ...
}

//上面代码中， testable函数的参数target， 就是会被装饰的类。



/*
如果觉得一个参数不够用，可以在装饰器外面再封装一层函数。
装饰器testable可以接受参数，这就等于可以修改装饰器的行为。

套娃传参！
*/

function testable(isTestable) {
	return function(target) {
		target.isTestable = isTestable;
	}
}

@testable(true)
class MyTestableClass {}
MyTestableClass.isTestable // true

@testable(false)
class MyClass {}
MyClass.isTestable // false

/*
注意，装饰器对类的行为的改变，是代码编译时发生的，而不是在运行时。
这意味着，装饰器能在编译阶段运行代码。
也就是说，装饰器本质就是  !编译时执行的函数!
*/


/*
前面的例子是为类添加一个静态属性， 如果想添加实例属性， 可以通过目标类的prototype对象操作。
*/

function testable(target) {
	target.prototype.isTestable = true;
}

@testable
class MyTestableClass {}

let obj = new MyTestableClass();
obj.isTestable // true


装饰器还没放出来, 暂时不要看了
